home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / SgCreateColorChooserDialog.z / SgCreateColorChooserDialog
Text File  |  1998-10-30  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4.      SSSSggggCCCCrrrreeeeaaaatttteeeeCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrDDDDiiiiaaaalllloooogggg((((UUUU3333NNNNXXXXIIII))))XXXX SSSSyyyysssstttteeeeSSSSmmmmggggCCCCVVVVrrrreeeeaaaatttteeeeCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrDDDDiiiiaaaalllloooogggg((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           SSSSggggCCCCrrrreeeeaaaatttteeeeCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrDDDDiiiiaaaalllloooogggg - The ColorChooser
  10.           ColorChooserDialog convenience creation function
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<SSSSggggmmmm////CCCCoooolllloooorrrrCCCC....hhhh>>>>
  14.  
  15.           WWWWiiiiddddggggeeeetttt SSSSggggCCCCrrrreeeeaaaatttteeeeCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrDDDDiiiiaaaalllloooogggg ((((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))))
  16.                WWWWiiiiddddggggeeeetttt    _p_a_r_e_n_t;;;;
  17.                SSSSttttrrrriiiinnnngggg    _n_a_m_e;;;;
  18.                AAAArrrrggggLLLLiiiisssstttt   _a_r_g_l_i_s_t;;;;
  19.                CCCCaaaarrrrddddiiiinnnnaaaallll  _a_r_g_c_o_u_n_t;;;;
  20.  
  21.  
  22.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  23.           This page documents the version of Sgm that accompanies
  24.           Motif 2.1.
  25.  
  26.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.           SSSSggggCCCCrrrreeeeaaaatttteeeeCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrDDDDiiiiaaaalllloooogggg is a convenience creation
  28.           function that creates a DialogShell and an unmanaged
  29.           ColorChooser child of the DialogShell.  ColorChooser is a
  30.           dialog widget that provides a friendly and powerful user
  31.           interface for selecting colors. The ColorChooser provides a
  32.           color hexagon and color sliders that presents the color
  33.           range in Hue, Saturation, Value, (HSV) and Red, Green, Blue,
  34.           (RGB) color spaces.  Because of drawing speed considiration
  35.           the color hexagon and color sliders are available only if
  36.           running under GL. For X only configuration there are Scale
  37.           widget to replace the color sliders and ther is no color
  38.           hexagon.  The ColorChooser includes the following:
  39.  
  40.           A menu for setting options for the color chooser.
  41.  
  42.             +o  A color hexagon that provides visual selection of the
  43.                Hue and Saturation components of a color in an Hue,
  44.                Saturation, Value, (HSV) color space.
  45.  
  46.             +o  Color slider for each of Hue, Saturation, Value, Red,
  47.                Green, Blue color components. The color sliders are
  48.                visible depening on the user color chooser menu
  49.                selection.  Each of the color sliders and the color
  50.                hexagon is accompanied with a text edit widget to view
  51.                the exact value of the current color component and to
  52.                set it's numerical value.
  53.  
  54.             +o  Two color swatches: one for showing the current
  55.                selected color and one for enabling the user to atore a
  56.                second color for reference.
  57.  
  58.             +o  Four buttons
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      SSSSggggCCCCrrrreeeeaaaatttteeeeCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrDDDDiiiiaaaalllloooogggg((((UUUU3333NNNNXXXXIIII))))XXXX SSSSyyyysssstttteeeeSSSSmmmmggggCCCCVVVVrrrreeeeaaaatttteeeeCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrDDDDiiiiaaaalllloooogggg((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           The default button labels are OOOOKKKK, CCCCaaaannnncccceeeellll, AAAAppppppppllllyyyy, and HHHHeeeellllpppp.
  75.           One additional WWWWoooorrrrkkkkAAAArrrreeeeaaaa child may be added to the
  76.           ColorChooser after creation.
  77.  
  78.           SSSSggggCCCCrrrreeeeaaaatttteeeeCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrrDDDDiiiiaaaalllloooogggg forces the value of the
  79.           ColorChooser resource XXXXmmmmNNNNddddiiiiaaaallllooooggggTTTTyyyyppppeeee to XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN.
  80.  
  81.           Use XXXXttttMMMMaaaannnnaaaaggggeeeeCCCChhhhiiiilllldddd to pop up the ColorChooserDialog (passing
  82.           the ColorChooser as the widget parameter); use
  83.           XXXXttttUUUUnnnnmmmmaaaannnnaaaaggggeeeeCCCChhhhiiiilllldddd to pop it down.
  84.  
  85.  
  86.           _p_a_r_e_n_t Specifies the parent widget ID
  87.  
  88.           _n_a_m_e   Specifies the name of the created widget
  89.  
  90.           _a_r_g_l_i_s_tSpecifies the argument list
  91.  
  92.           _a_r_g_c_o_u_n_t
  93.                  Specifies the number of attribute/value pairs in the
  94.                  argument list (_a_r_g_l_i_s_t)
  95.  
  96.  
  97.           For a complete definition of ColorChooser and its associated
  98.           resources, see SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX)))).
  99.  
  100.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  101.           Returns the ColorChooser widget ID.
  102.  
  103.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  104.           SSSSggggCCCCoooolllloooorrrrCCCChhhhoooooooosssseeeerrrr((((3333XXXX)))).
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.